home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mr2_139.zip / MR2.DOC < prev    next >
Text File  |  1992-04-08  |  50KB  |  1,345 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           MR/2 - A QWK Compatible Mail Reader for OS/2
  10.           User's Manual
  11.  
  12.           Introduction
  13.           ============
  14.  
  15.           MR/2 is an offline  mail reader for use with  QWK compatible mail
  16.           packets.   It is a  native OS/2 character-mode  reader written in
  17.           C++, using Zortech's 3.0 release.
  18.  
  19.           Simple help screens are  available at any time by  depressing F1.
  20.           If you find a spot where HELP is unavailable, please report  this
  21.           to the author. The  package was initially tested under  OS/2 1.3,
  22.           however, most  later development and testing  was performed using
  23.           2.0 beta versions 6.149, 6.167F and 6.177H (LA).
  24.  
  25.           This  IS a shareware package, and does require a registration fee
  26.           if  you  choose  to  continue  using it  after  30  days.     The
  27.           registration fee is currently  $20.  When you register,  you will
  28.           be  sent an indifvidually serialized  MR2.ID file.   This file is
  29.           placed  in the  MR/2 home  directory, and  the "NR"  markings are
  30.           removed  from the  taglines of  subsequent replies.   Optionally,
  31.           your serial number can be included in  each tagline.    The  more
  32.           interest (read:  registered users) I get, the more likely I am to
  33.           continue with improvements.
  34.  
  35.           ----------------------------------------------------------------
  36.           IMPORTANT:  READ THE READ.ME FILE FOR NEW FEATURES AND BUG FIXES
  37.           ----------------------------------------------------------------
  38.  
  39.           DISCLAIMER OF WARRANTY
  40.           ======================
  41.  
  42.           THIS SOFTWARE AND  MANUAL ARE  DISTRIBUTED AND SOLD  "AS IS"  AND
  43.           WITHOUT WARRANTIES  AS TO  PERFORMANCE OF MERCHANTABILITY  OR ANY
  44.           OTHER  WARRANTIES WHETHER EXPRESSED  OR IMPLIED.   BECAUSE OF THE
  45.           VARIOUS  HARDWARE  AND  SOFTWARE  ENVIRONMENTS  INTO  WHICH  THIS
  46.           PROGRAM  MAY  BE PUT,  NO WARRANTY  OF  FITNESS FOR  A PARTICULAR
  47.           PURPOSE IS OFFERED.
  48.  
  49.           GOOD OPERATING PROCEDURE DICTATES  THAT ANY PROGRAM BE THOROUGHLY
  50.           TESTED WITH NON-CRITICAL  DATA BEFORE  RELYING ON IT.   THE  USER
  51.           MUST ASSUME THE ENTIRE RISK OF USING  THE PROGRAM.  ANY LIABILITY
  52.           OF THE SELLER WILL BE  LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT
  53.           OR REFUND OF PURCHASE PRICE. 
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.           ----------------------------------------------------------------
  62.           MR/2 User's Guide                                      Page  1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           Major Features
  71.           ==============
  72.  
  73.           o    OS/2 Character mode specific.
  74.  
  75.           o    Menu and Selection list interface.
  76.  
  77.           o    Context sensitive help.
  78.  
  79.           o    Mouse support (although somewhat strange at times)
  80.  
  81.           o    Multithreaded message searching.  Soundexing optional.
  82.  
  83.           o    Load  your  existing editor  on-demand  or  edit in  another
  84.                session's window.
  85.  
  86.           o    Configurable via the MR2.INI text file.
  87.  
  88.           o    Bookmark-like features using extended attributes attached to
  89.                each packet.
  90.  
  91.           o    ANSI  support  for  BBS  provided screens  (no  support  for
  92.                messages.)
  93.  
  94.           o    No  fixed limits for messages,  conferences, etc.  If enough
  95.                memory is there, MR/2 can handle it.
  96.  
  97.           o    Message can  be entered for a target  BBS, even if no packet
  98.                for that BBS exists  (BBS must have been read  at least once
  99.                with MR/2).
  100.  
  101.           o    Full  tagline support  with enhanced  tagline stealing.   If
  102.                MR/2 doesn't steal the right line, you can choose another.
  103.  
  104.           o    Most  of  the "normal"  features  of  other QWK  reader  are
  105.                included or are on  the list of future enhancements.   Ideas
  106.                and suggestions are always welcome.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.           ----------------------------------------------------------------
  123.           MR/2 User's Guide                                      Page  2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           Installing MR/2
  132.           ===============
  133.  
  134.           Unpack   the  MR2_100.ZIP  file  into  an  appropriate  directory
  135.           ("\MR2", for instance).   All MR/2 files should be  kept together
  136.           in the same  directory.  You  must invoke MR/2 only  while pathed
  137.           into this directory - this is the only way that MR/2 will be able
  138.           to find its supporting files.
  139.  
  140.           Unpacking MR2_100.ZIP is all  that's involved in installing MR/2.
  141.           You may  choose to create  and edit an ".ini"  parameter file for
  142.           MR/2.   This file may be used to set up various run-time options.
  143.           A template file, "MR2INI.ORG"  is provided that provides examples
  144.           of all available parameters along with some explanations.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.           ----------------------------------------------------------------
  184.           MR/2 User's Guide                                      Page  3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.           MR/2 Setup - the MR2.INI file
  193.           =============================
  194.  
  195.           When MR/2 is invoked for the  very first time (actually, any time
  196.           where  the  file  "MR2.INI" is  not  found),  it  will allow  for
  197.           creation  of  this  file.  A  short  prompt  will  ask  for  your
  198.           permission, and if given, the file "MR2INI.ORG" will be copied to
  199.           "MR2.INI", and the OS/2  system "E" editor will be  loaded, ready
  200.           for you  to make any desired  modifications.  Once the  editor is
  201.           exited, you will see the MR/2 packet selection screen.
  202.  
  203.           It is very important to identify the correct "packet path" in the
  204.           MR2.INI  file. This must identify the directory in which all your
  205.           .QWK  packets are  kept.   MR/2  does  include a  provisions  for
  206.           changing the "packet  path" on  demand, in leu  of modifying  the
  207.           MR2.INI file and reloading.  From the packet selection screen (or
  208.           the  "no  packets found"  message box),  the  packet path  may be
  209.           edited by pressing ALT-P.
  210.  
  211.           The initial  MR2.INI file contains an explanation of each option.
  212.           Examine  and set  these options  carefully to  fit your  specific
  213.           needs.
  214.  
  215.           If  you fail  or neglect to  edit the MR2.INI  file, the defaults
  216.           will  look for packets in the MR/2  home directory.  MR/2's basic
  217.           install provides a "Welcome.QWK"  packet that provides some basic
  218.           instructions.
  219.  
  220.           MR2.INI File Options
  221.           --------------------
  222.  
  223.           PacketPath=g:\dl\
  224.  
  225.                This is where MR2 will look for packets to read.  A wildcard
  226.                specification is  built  from this  specification, with  the
  227.                FileSpec string appended to it.
  228.  
  229.           FileSpec=*.q??
  230.  
  231.                This  is  the  wildcard   file  specification  to  use  when
  232.                searching for packets to  read.  This string is  appended to
  233.                the  PacketPath   string   and  all   files  matching   this
  234.                combination are listed as packets.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.           ----------------------------------------------------------------
  245.           MR/2 User's Guide                                      Page  4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.           Editor=e
  254.           Editor=epm
  255.           Editor=q -e..\qstartup.mac
  256.  
  257.                This is the command  MR2 will use when invoking  the editor.
  258.                By default,  the system PM editor "e" is used.  To use QEdit
  259.                and pass  it a  start-up macro  (-e parameter), change  this
  260.                line to read:
  261.  
  262.                          Editor=q -ef:\mr2\qstartup.mac
  263.  
  264.                NOTE: when using  the PM "E" or "EPM"  editors - "word wrap"
  265.                appears  to  work great,  however,  lines  are not  actually
  266.                broken with  CR/LF's.   This causes formatting  problems for
  267.                MR/2.  Keep Word Wrap off and include linefeeds by hand.
  268.  
  269.           Attributes=NONE
  270.           Attributes=Extended
  271.  
  272.                When preparing to edit reply files, MR/2 can optionally mark
  273.                these  files as type "Plain  Text" so, for  example, the "E"
  274.                editor will not force you to set the type before saving.
  275.  
  276.           ReplyFile=C:\Reply.Msg
  277.  
  278.                Temporary file name  used when creating replies.   This file
  279.                can be specified with a full path, making  easier to edit it
  280.                in a separate window.
  281.  
  282.           HeaderEditing=Both
  283.  
  284.                This  controls  when the  Message  header  is displayed  for
  285.                editing. Options, relative to actually editing the reply are
  286.                Before, After or Both.
  287.  
  288.           ReplyPath=g:\rep\
  289.  
  290.                Directory  where   ".Rep"  reply   packets  are   built  and
  291.                maintained.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.           ----------------------------------------------------------------
  306.           MR/2 User's Guide                                      Page  5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.           Tagline=@OS2.Tag
  315.           Tagline=A QWK compatible mail reader for OS/2
  316.  
  317.                This  sets the default tagline  for MR/2 replies.   A single
  318.                tagline can be "fixed" for all messages (example #2, above),
  319.                or  a  file  of  taglines  can  be  accessed  and  "rotated"
  320.                automatically (example #1 - the "@" symbol tells MR/2 to get
  321.                taglines from  the file name  following it).   With rotating
  322.                taglines  from  a  file,  each message  seems  to  receive a
  323.                different tagline.
  324.  
  325.                A  tagline is a humorous or interesting phrase placed at the
  326.                bottom of each reply.
  327.  
  328.           TagMode=RANDOM
  329.  
  330.                This  sets the tagline file access method.  RANDOM will skip
  331.                around  and randomly  select the  next tagline.   SEQUENTIAL
  332.                will perform a RANDOM  seek when MR/2 is first  loaded, then
  333.                move sequentially through the file after that.
  334.  
  335.           SerialInTagline=Yes
  336.  
  337.                This  option pertains only to registered copies of MR/2.  If
  338.                you have registered  and have  the MR2.ID file  in the  MR/2
  339.                home  directory,  you may  set  this  parameter as  desired.
  340.                Specifying "YES"  (the default), tells MR/2  to include your
  341.                registration serial number in all taglines.  Specifying "NO"
  342.                will suppress the serial number.  In either case, registered
  343.                users will not see the "NR" marking in their tags.
  344.  
  345.           SaveFile=..\save.txt
  346.  
  347.                This is the default file to which messages are appended when
  348.                they are  "saved" or filed for later reference.  Use the "S"
  349.                key while viewing  a message  to append it  to this file  in
  350.                printable form.
  351.  
  352.           Zipper=pkzip
  353.           UnZipper=pkunzip -o
  354.  
  355.                These  are the commands  used to archive  and unarchive your
  356.                message  packets.     If   you  use  something   other  than
  357.                PKZip/UnZip, modify these commands appropriately.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.           ----------------------------------------------------------------
  367.           MR/2 User's Guide                                      Page  6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.           Colors=1E171E
  376.           Colors=0F0E0A
  377.  
  378.                Yes, this is  crude - I'll  include something more  friendly
  379.                later. The  first two characters describe  the "normal" text
  380.                color  for  messages, which  is shown  here  as 1E,  or Blue
  381.                background (1) Yellow foreground (E).
  382.  
  383.                The  second  two  are  the quoted-text  colors,  17  is Blue
  384.                background (1) with a  White foreground (7).  The  third set
  385.                of 2  numbers are  the message  header  display colors  (the
  386.                From/To/Subject section  on top).   This  is the  only color
  387.                configuration support at this time.
  388.  
  389.                Colors:
  390.                   0 = Black    1 = Blue   2 = Green  3 = Cyan  4 = Red
  391.                   5 = Magenta  6 = Brown  7 = White  8 = Gray  9 = Lt Blue
  392.                   A = Lt. Green        B = Lt. Cyan      C = Lt. Red
  393.                   D = Lt. Magenta      E = Yellow        F = Intense White
  394.  
  395.                I personally have changed to  the second example here, which
  396.                gives a black background with bold-white text, yellow quotes
  397.                and green header.
  398.  
  399.           SkipReadMessages=No
  400.  
  401.                If  set to YES, MR/2 will bypass any messages you've already
  402.                read.  The problem with this option is that, if a conference
  403.                contains only previously-read messages,  then MR/2 will skip
  404.                right out of  that conference - there's  no way to  get back
  405.                in.
  406.  
  407.           QuoteBody="%i>",EachLine
  408.  
  409.                Describes  how  MR/2 will  quote  the  lines of  the  source
  410.                message when creating  a new  reply file.   The optional  %i
  411.                (which is the only parameter-type variable supported at this
  412.                time) will be replaced by the message originator's initials.
  413.                The  quote  prefix  may be  placed  on  EachLine  or on  the
  414.                "FirstLine" only (subsequent lines indented).
  415.  
  416.           OldQuoteDetect=YES
  417.  
  418.                When set  to YES, MR/2  will not place  the quote  prefix in
  419.                front  of reply-file  lines that  already are  prefixed with
  420.                quotes.  This creates (usually) a much cleaner initial reply
  421.                file.
  422.  
  423.  
  424.  
  425.  
  426.  
  427.           ----------------------------------------------------------------
  428.           MR/2 User's Guide                                      Page  7
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.           HeaderInQuote=No
  437.                You  may optionally  include the  message header in  a reply
  438.                file.  This is  often used with a  clever editor "macro"  to
  439.                create sophisticated quoting  styles not natively  supported
  440.                my  MR/2.   You must  be sure  to remove  all traces  of the
  441.                header before saving  the message, as MR/2 makes  no attempt
  442.                to identify or remove it.
  443.  
  444.           KeepMessageMarks=YES
  445.  
  446.                If set to YES, MR/2 will track the read/replied/saved status
  447.                of  every message, as well  as your current  position in the
  448.                packet.    This  information  is  stored  as  OS/2  extended
  449.                attributes  and  will stay  attached to  the  file as  it is
  450.                copied or  renamed.    When  a  previously  read  packet  is
  451.                reopened,  you will be  asked if you  wish to  return to you
  452.                previous position.   Answering YES  will return you  to that
  453.                spot,  responding  NO  will  place  you  at  the  conference
  454.                selection screen.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.           ----------------------------------------------------------------
  489.           MR/2 User's Guide                                      Page  8
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.           Using MR/2 for the First Time
  498.           =============================
  499.  
  500.           MR/2's user  interface consists mainly of  menus, selection lists
  501.           and  confirmation  prompts.    This, coupled  with  the  context-
  502.           sensitive help, makes it  relatively easy to use, even  without a
  503.           manual.
  504.  
  505.           The ESCAPE  key will always move  you back to a  previous menu or
  506.           list.  It can be used to exit MR/2 when the Packet Selection List
  507.           is displayed.
  508.  
  509.           Menus
  510.           -----
  511.           To  select from  a menu,  simply use  the up/down  arrow keys  to
  512.           highlight the desired option and press enter.  Alternatively, you
  513.           may click on  an entry with the  mouse.  Usually, a  "hot key" is
  514.           defined  for  each  entry.    This  key  is  normally  the  first
  515.           capitalized character in the selection (e.g., "E" for "Exit"  and
  516.           "M" for "Mail").
  517.  
  518.           Selection Lists
  519.           ---------------
  520.           Many MR/2  items are  displayed for interaction  using "Selection
  521.           Lists".  For instance,  the list of available packets, as well as
  522.           the list  of conferences  that contain  mail, both  use Selection
  523.           Lists.
  524.  
  525.           There are several methods  for choosing an item from  a Selection
  526.           List.   The simplest method involves using the up/down arrow keys
  527.           to move the highlight bar to the desired element.   ENTER is then
  528.           used to  select the highlighted item.   If you choose  to use the
  529.           mouse, simply "click" on the desired element.
  530.  
  531.           If more  than one page of  items exist, you may  move through the
  532.           list a  screen at a  time using the  PAGE UP and PAGE  DOWN keys.
  533.           The HOME key  may be used to move  to the very first item  in the
  534.           list, as the  END key moves to  the last.  Pressing  PAGE DOWN on
  535.           the last page of the list will move the highlight bar to the very
  536.           last element as well.
  537.  
  538.           Some  Selection Lists enable  other "special"  keystroke options.
  539.           These   additional  functions   will   be   discussed  in   their
  540.           corresponding sections.
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.           ----------------------------------------------------------------
  550.           MR/2 User's Guide                                      Page  9
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.           Selecting a QWK Packet
  559.           ======================
  560.  
  561.           After MR/2 has been  configured, the first thing that  is usually
  562.           displayed  is the Packet Selection  List.  Displayed  will be the
  563.           names  of  all QWK  packets  found, as  defined  by the  path and
  564.           wildcard specification in MR2.INI.
  565.  
  566.           Packets are  displayed in  date/time-order, with the  most recent
  567.           packet  being at  the  top of  the list.   To  open a  packet for
  568.           reading, simply choose it  by highlighting the name and  pressing
  569.           ENTER.   The  chosen packet  will be  "unpacked" and  readied for
  570.           reading.
  571.  
  572.           Deleting a Packet
  573.           -----------------
  574.           You  may delete any packet displayed on the Packet Selection list
  575.           by positioning  the highlight bar  on it and  pressing ALT-D.   A
  576.           confirmation box will be displayed, and if acknowledged, the file
  577.           will be deleted and the display updated.
  578.  
  579.           Renaming a Packet
  580.           -----------------
  581.           You  may rename any packet displayed on the Packet Selection list
  582.           by positioning the  highlight bar  on it and  pressing ALT-R.   A
  583.           form will be  displayed prompting for a "new" name.   Fill in the
  584.           desired  new name and  press ENTER to rename  the file and update
  585.           the display.  You may instead press ESCAPE to cancel the rename.
  586.  
  587.           You  may delete any packet displayed on the Packet Selection list
  588.           by positioning  the highlight bar on  it and pressing CTRL-D.   A
  589.           confirmation box will be displayed, and if acknowledged, the file
  590.           will be deleted and the display updated.
  591.  
  592.           Relisting the Packets Available
  593.           -------------------------------
  594.           Pressing ALT-N will cause  MR/2 to rebuild the list  of available
  595.           packets.   This  is  particularly handy  when  packets are  being
  596.           downloaded in another  session and may  not show up  on an  older
  597.           list.
  598.  
  599.           Changing your current Packet Path
  600.           ---------------------------------
  601.           The  packets  normally listed  are those  found  to exist  in the
  602.           packet  path specification within  MR2.INI.   You may  change the
  603.           packet path  and wildcard specifiers used to  find files "on-the-
  604.           fly".  Simply press ALT-P and modify the displayed specification,
  605.           then press ENTER to obtain the updated packet list.
  606.  
  607.  
  608.  
  609.  
  610.           ----------------------------------------------------------------
  611.           MR/2 User's Guide                                      Page  10
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.           Modifying the MR2.INI file
  620.           --------------------------
  621.           While  on the Packet Selection screen, access to the MR2.INI file
  622.           for modifying with  the default text  editor is provided  through
  623.           the  ALT-C key combination.   This will call  your editor (or the
  624.           default of the "E" editor, if not specified) and load the MR2.INI
  625.           file.  Once you exit the editor, MR/2 reloads the  .ini file, and
  626.           changes take effect immediately.
  627.  
  628.           Entering Message for a BBS without a Packet
  629.           -------------------------------------------
  630.           While on the Packet Selection List, you may press ALT-E to  enter
  631.           messages for any  BBS ever  accessed through MR/2.   This  allows
  632.           messages to be entered for a BBS when all previously read packets
  633.           have been deleted.
  634.  
  635.           When you  open any  packet  with MR/2,  the BBS  control data  is
  636.           copied into the MR/2 home  directory.  The name of the  file will
  637.           be built  from the  BBS name  "ID", suffixed  with  ".cfg".   For
  638.           instance,   If  the BBS  ID is  NerdNook, then  the file  will be
  639.           called "NerdNook.cfg".
  640.  
  641.           A list of BBS ".cfg" files is displayed by pressing ALT-E,  while
  642.           the normal Packet Selection List  is removed from view.   You may
  643.           use the ESCAPE key  to return to the list of  packets, or you may
  644.           choose one of the BBS name for new message entry.
  645.  
  646.           Once a BBS name is picked, MR/2 checks for existing  replies.  If
  647.           any are found for the specified BBS, you are asked if you wish to
  648.           keep  these, or discard them.  Respond appropriately.  The Packet
  649.           Main Menu is  now displayed  with some of  the options  disabled.
  650.           You will only be allowed to enter new messages, as well as review
  651.           any previous messages.
  652.  
  653.           See  "Creating New  Messages",  below, for  more instructions  on
  654.           creating unprovoked messages.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.           ----------------------------------------------------------------
  672.           MR/2 User's Guide                                      Page  11
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.           The "Unpacking" Process
  681.           =======================
  682.  
  683.           If you  choose a packet for  reading, it is unarchived  using the
  684.           unpacking  utility defined in MR2.INI.  If this command fails, an
  685.           informational box will be  displayed showing the complete command
  686.           for debugging and correction.
  687.  
  688.           After  the packet  is  unpacked, a  check  is made  for  existing
  689.           replies.  If replies  for the packet's source BBS are  found, you
  690.           are asked  if you wish to keep or discard them.  If these replies
  691.           have been previously uploaded  to the BBS, you may  discard them,
  692.           otherwise, you will probably want to keep them.
  693.  
  694.           If  you have not disabled the "bookmark" feature (it's enabled by
  695.           default), then another prompt may appear.  If you have previously
  696.           read part of the current packet, you will be asked if you wish to
  697.           return  to your previous  reading position.   Responding YES will
  698.           place  you at  the  last  message  MR/2 remembered  you  reading.
  699.           Responding NO will place you at the Packet Main Menu.
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.           ----------------------------------------------------------------
  733.           MR/2 User's Guide                                      Page  12
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.           Packet Main Menu
  742.           ================
  743.  
  744.           Once a packet  is ready for reading, the Main  Menu is displayed.
  745.           The following options are listed:
  746.  
  747.                Mail
  748.                Write new
  749.                Files
  750.                News
  751.                Bulletins
  752.                Exit
  753.  
  754.           MR/2  will  examine  the  contents  of  the  current  packet  and
  755.           enable/disable any of these options that are not applicable.  For
  756.           instance, if the packet contains no "new files" listing, then the
  757.           "Files" option will display de-emphasized and can not be chosen.
  758.  
  759.           Mail
  760.           ----
  761.           Select  this option to read the messages contained in the current
  762.           packet.   Once selected, a list  of conferences with mail will be
  763.           displayed.   If any messages  addressed specifically  to you  are
  764.           found, a "Personal" conference will  be placed at the top  of the
  765.           list for easy access.   Next to each conference,  in parenthesis,
  766.           will be the number of messages found in that conference.
  767.  
  768.           If more than  one screen of  conferences exist, you  may use  the
  769.           PAGE UP/DOWN keys, or the arrow  keys to move through them.  HOME
  770.           and END are also functional here.
  771.  
  772.           Searching All Conferences
  773.           -------------------------
  774.           While  on the Conference Selection screen, you have the option of
  775.           searching  all conference with mail for one or more text strings.
  776.           Pressing ALT-F  will  bring up  the Search  Criteria entry  form.
  777.           Fill  in the  text  string  you wish  to  find  and press  ENTER.
  778.           Matching entries  will be queued  up and displayed  as requested.
  779.           See  the  section   on  searching  below  for   a  more  detailed
  780.           description.
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.           ----------------------------------------------------------------
  794.           MR/2 User's Guide                                      Page  13
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.           Reading Messages
  803.           ----------------
  804.           After Choosing the conference you wish to read, the first message
  805.           in that conference  will be displayed.  At this  point, a variety
  806.           of options present themselves.  Remember, pressing F1  at anytime
  807.           while  in MR/2 will display  a help screen  listing the available
  808.           keystrokes.   Pressing F1 while  on a message  display results in
  809.           the following information being displayed:
  810.  
  811.           -----------------------------------------------------------------
  812.                               MESSAGE READING HELP
  813.  
  814.           The following keys are available while reading messages:
  815.  
  816.           ENTER/+ Move forward one message         P - Print to "prn"
  817.             G/-   Move backward one message        O - Shell a command line
  818.             I     Select individual messages by header information
  819.             K     Kill the current reply (reply conference ONLY)
  820.             R     Reply to the current message/modify a reply
  821.             S     Print the message to the save file
  822.             F     Find text within the current conference
  823.             N     Find NEXT match for current text search
  824.             L     Find PREVIOUS match for current text search
  825.             X     Exit MR/2 fast - without cleanup, on confirmation
  826.             H/B   Move forward/backward by thread
  827.             T     Steal the current message's tagline
  828.  
  829.             PAGE UP/DOWN       To move forward/backward one screen
  830.             UP/DOWN ARROW      To scroll up/down one line
  831.             RIGHT/LEFT ARROW   To scroll the view right/left
  832.             HOME/END           To jump to the beginning/end of the message
  833.             spacebar           Page forward - next message if at end
  834.             ESCAPE             Exit the current display
  835.           -----------------------------------------------------------------
  836.  
  837.           Some  of  these  options  are self-explanatory  and  will  not be
  838.           discussed further.
  839.  
  840.           Using the Spacebar
  841.           ------------------
  842.           The  spacebar will move forward  through message one  screen at a
  843.           time.   For  instance,  if a  message  is three  "screens"  long,
  844.           pressing the spacebar will show you screen two, pressing it again
  845.           screen three.  When it's pressed the next time,  the next message
  846.           in sequence will be displayed.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.           ----------------------------------------------------------------
  855.           MR/2 User's Guide                                      Page  14
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.           Mousing Around
  864.           --------------
  865.           Some  mouse  support is  provided  when  on the  message  viewing
  866.           screen.    Clicking in  various areas  or  on certain  words will
  867.           perform  functions  equivalent   to  the  more  common   keyboard
  868.           commands.  For example:
  869.  
  870.           o    Click on  the bottom  "status" line  works the  same as
  871.                hitting ENTER.
  872.  
  873.           o    Click  on the  next  line up  (last  display line)  and
  874.                you've simulated "spacebar".
  875.  
  876.           o    Any other line on  the bottom half of the  message area
  877.                is a page-down.
  878.  
  879.           o    Click on any line in the top half of the message is the
  880.                same as a "page up".
  881.  
  882.           o    Click  on  the "=="  header  dividing  line and  you've
  883.                requested the previous  message ("G" or "-").
  884.  
  885.           o    Click on  "Subject:" pages forward  by thread,  "Conf:"
  886.                brings up the index and on "Hit" (or where it should be
  887.                displayed) for the next search.
  888.  
  889.  
  890.           Selecting Messages by Header Information
  891.           ----------------------------------------
  892.           Pressing "I" or the INSERT key  will bring up the Message  Header
  893.           Selection List.  Messages  will be listed, one per  display line,
  894.           providing the message number, from-name, to-name and subject.  If
  895.           a  message has been previously read, an asterisk "*" will proceed
  896.           its entry.   If a message  has been saved,  replied to or  killed
  897.           (replies  only), status  marks will be  placed at the  end of the
  898.           entry ("S", "R", "K", respectively).
  899.  
  900.           To select a message, simply move the highlight bar to the desired
  901.           entry and press  ENTER.  The mouse may  also be used, as  well as
  902.           all other standard selection list keystrokes.
  903.  
  904.           When the Message Header List is displayed, the highlight bar will
  905.           be positioned on the currently displayed message.
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.           ----------------------------------------------------------------
  916.           MR/2 User's Guide                                      Page  15
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.           Replying
  925.           --------
  926.           When you find a message  that you wish to reply to,  simply press
  927.           "R".   MR/2  will "quote"  the message  (i.e., copy  the original
  928.           message  with the author's initials)  to a reply  file and invoke
  929.           the editor  defined in your MR2.INI file, if one is defined.  The
  930.           quoted  message is usually modified  by trimming off excess lines
  931.           and making it  look more presentable.   Add the desired  reply to
  932.           the end of the quoted section.
  933.  
  934.           Once the  reply is complete, save  it and exit the  editor.  MR/2
  935.           will retrieve the modified file and record it as a reply.
  936.  
  937.           You  will  be  asked to  review  and  accept  the "reply  header"
  938.           information,  either  before  or  after  editing  the  reply,  or
  939.           sometimes  in  both instances.    This is  "configurable"  via an
  940.           option  in the  MR2.INI  file.    Usually,  the  header  will  be
  941.           acceptable unchanged.  You do have the option, though, to do such
  942.           things  as change  the  addressee name,  conference, tagline  and
  943.           security status.   Also,  if you  wish to  reply and  address the
  944.           message to  the original messages  addressee, the F3  "Toggle To"
  945.           function  is available.   Also,  you may pick a different tagline
  946.           from a list of those available by pressing F2.
  947.  
  948.           Using an Editor in a Separate Window/Session
  949.           --------------------------------------------
  950.           While loading an editor "on demand" is usually  quick and easy in
  951.           character mode,  using a PM based editor  can be cumbersome.  For
  952.           this reason, MR/2  provides an  option for editing  replies in  a
  953.           separate session.
  954.  
  955.           First,  the MR2.INI file should contain  a line specifying "NONE"
  956.           for the editor:
  957.  
  958.                Editor=NONE
  959.  
  960.           You may  also wish to declare  the name of the  "ReplyFile" to be
  961.           simple and easy to  locate (e.g., "C:\Reply").  When  you request
  962.           to reply to a message,  MR/2 will quote the message to  the named
  963.           reply  file.   With the  editor option set  to "NONE",  MR/2 then
  964.           merely posts an informative "Waiting - press any key" message and
  965.           waits for  a key press.   This  allows you to  switch to  another
  966.           session, load the  reply file, modify it,  save it and return  to
  967.           MR/2.   Once a key  is pressed,  MR/2 retrieves  and records  the
  968.           reply in the normal way.
  969.  
  970.           NOTE:  You must  be sure to save the  reply and release the  file
  971.           before switching back to MR/2, as MR/2 provides very little error
  972.           checking in this mode.
  973.  
  974.  
  975.  
  976.           ----------------------------------------------------------------
  977.           MR/2 User's Guide                                      Page  16
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.           Killing the Current Reply
  986.           -------------------------
  987.           Once a reply  exists, the Conference Selection  list will include
  988.           an  entry for reviewing replies.  You  may read these in the same
  989.           manor as  you read regular  incoming mail.   If you find  a reply
  990.           that you  wish to remove, you  may "kill" it by  pressing the "K"
  991.           key.  After confirming this action, MR/2 will mark the message as
  992.           "killed".  It  will still be viewable, but will  not be packed in
  993.           the reply file.
  994.  
  995.           NOTE:  As long as you don't leave the current session and packet,
  996.           any killed reply can  be "unkilled" easily.   Simply move to  the
  997.           message to be retrieved and press "R" to modify the  reply.  Save
  998.           the message as-is and  the killed status will  be removed.   Once
  999.           you  exit the current packet  and replies are  packed, any killed
  1000.           messages are gone forever.
  1001.  
  1002.           Modifying a Reply
  1003.           -----------------
  1004.           Once  at least  one reply  exists, the Conference  Selection list
  1005.           will include an entry for reviewing replies.   You may read these
  1006.           in the same manor as you read regular incoming mail.  If you find
  1007.           a  reply that you wish to  modify, you may do  so by pressing the
  1008.           "R"  key.  The message  will be displayed  for modification using
  1009.           the  default editor.    Make the  desired  changes and  save  the
  1010.           message  and MR/2 will place  the updated message  into the reply
  1011.           file.
  1012.  
  1013.           Searching
  1014.           ---------
  1015.           You  may  search  a conference  for  one  or  more text  strings.
  1016.           Messages  found contain the string(s) will be displayed, one at a
  1017.           time.    Searching  is  multithreaded, meaning  that  while  your
  1018.           viewing  the first  (or subsequent)  matching message,  MR/2 will
  1019.           continue to search through the rest of the messages for more.
  1020.  
  1021.           To search the current  conference, simply press "F" while  on any
  1022.           message  from  that  conference.   This  will  invoke  the Search
  1023.           Criteria  Entry form.   Fill in a  text string to  search for and
  1024.           press ENTER.   You will have  to wait until MR/2  finds the first
  1025.           match, which will then be displayed for your viewing.
  1026.  
  1027.           When  a  "hit" is  displayed, MR/2  will  attempt to  display the
  1028.           message  so that the message line containing the matching text is
  1029.           the second display line.  If the match was caused by the From, To
  1030.           or  Subject fields, then the message is displayed at its starting
  1031.           point.
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.           ----------------------------------------------------------------
  1038.           MR/2 User's Guide                                      Page  17
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.           While performing  the search, MR/2 constantly  updates the bottom
  1047.           line   of  the   screen   with  information   on  its   progress.
  1048.           Additionally,  while viewing  search  result, "Hit  x  of xx"  is
  1049.           updated in the upper right corner of the display.
  1050.  
  1051.           Multiple Search Strings
  1052.           -----------------------
  1053.           You may search for more than one text strings in a single pass by
  1054.           separating the different strings with backslashes "\".  MR/2 will
  1055.           check  each message for each  separate string, and  will call the
  1056.           message a "match" if any one of them is found.
  1057.  
  1058.           Soundex Searching
  1059.           -----------------
  1060.           MR/2 also  supports "soundex" searching, or  searching for sound-
  1061.           alike  words.   To request  a soundex  search, simply  prefix the
  1062.           search text with an ampersand "&".  For instance, "&Windoze" will
  1063.           match Windows, windoze, etc.,.  The soundexing  algorithm is very
  1064.           loose, requiring the use of larger words in order to  avoid a hit
  1065.           on every message.
  1066.  
  1067.           Examining Search Results
  1068.           ------------------------
  1069.           You may  move  freely  through  any  resulting  message  hits  by
  1070.           pressing "N" for  the "Next"  message, or "L"  for the "Last"  or
  1071.           previous message.  Alternatively,  you may use the mouse  to move
  1072.           forward by clicking on the "Hit x of xx" status area.
  1073.  
  1074.           Requesting  a new search will destroy the results of the previous
  1075.           search.   Escaping  to the  Conference Selection  List will  also
  1076.           discard the results.
  1077.  
  1078.           If you  request a "next" or "previous" record, and you are at the
  1079.           beginning  or  end  of  the  list  of  hits,  MR/2  will  post an
  1080.           information box and wait for a key.
  1081.  
  1082.           Searching All Conferences
  1083.           -------------------------
  1084.           As  mentioned  previously,  you  can   search  for  text  in  all
  1085.           conferences by  pressing ALT-F on the  Conference Selection List.
  1086.           The search  process will  be performed in  a manner similar  to a
  1087.           single  conference search.  When reviewing messages found in this
  1088.           way, many of  the keystrokes normally  available are disabled  or
  1089.           their  behavior  is modified.   For  example,  since there  is no
  1090.           sequential "next" record, pressing ENTER will give you the "next"
  1091.           message hit.
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.           ----------------------------------------------------------------
  1099.           MR/2 User's Guide                                      Page  18
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.           Saving to a Text File
  1108.           ---------------------
  1109.           If you  wish to save any message to a text-based save file, press
  1110.           "S" while  viewing the message.   This will invoke the  Save File
  1111.           Name form with the default name of the last file name  used.  You
  1112.           may used this file name  simply by pressing ENTER.  You  may make
  1113.           any manual changes to the name desired and then press  ENTER.  If
  1114.           you wish to select from a  list of existing save files,  pressing
  1115.           F2 will  provide a list from which to  choose.  The list if built
  1116.           from  scanning  the disk  for  wildcard matches  built  using the
  1117.           currently  displayed name.    You  may  place  wildcards  in  the
  1118.           displayed specification to control the displayed list.
  1119.  
  1120.           Reading by Subject/Thread
  1121.           -------------------------
  1122.           You  may  move forward  or  backwards through  messages  based on
  1123.           subject by pressing "H" for forward movement or "B" for backwards
  1124.           movement.   You may also click  the mouse on the  Subject area of
  1125.           the message to move forward by thread.
  1126.  
  1127.           Fast Exit from MR/2
  1128.           -------------------
  1129.           You may exit  MR/2 quickly any time you are  reading a message by
  1130.           pressing "X".   This  will bypass  the display of  all menus  and
  1131.           selection  lists normally performed when  you use ESCAPE to "back
  1132.           out"  of the  program.   It  will also  suppress  the packing  of
  1133.           replies and the cleanup of  the work directory.  This will  allow
  1134.           you to  reenter MR/2 at a  later time, and pick  up exactly where
  1135.           you left off.
  1136.  
  1137.           Spawning an OS/2 command line
  1138.           -----------------------------
  1139.           While  somewhat redundant,  access to  the  OS/2 command  line is
  1140.           provided  by  pressing "O"  while viewing  a  message.   You MUST
  1141.           remember to use the "exit" command to return to MR/2.
  1142.  
  1143.           Printing
  1144.           --------
  1145.           You  may  format  any message  to  the  default  "prn" device  by
  1146.           pressing  the  "P"  key.    No   prompting  for  confirmation  is
  1147.           performed, and error checking is non-existent.
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.           ----------------------------------------------------------------
  1160.           MR/2 User's Guide                                      Page  19
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.           Stealing Taglines
  1169.           -----------------
  1170.           MR/2  has the  ability  to "steal"  a  tagline from  the  current
  1171.           message  and add  it to  the tagline  file specified  in MR2.INI.
  1172.           While viewing a message with  a tagline you want to swipe,  press
  1173.           "T".  MR/2 will attempt  to determine which of the lines  is most
  1174.           likely a  tagline, an  extract this  line.   The  chosen line  is
  1175.           displayed for confirmation, and you  may make any desired changes
  1176.           to it  at this time.   If the line automatically  selected is not
  1177.           the tagline you want, you can use  the up and down arrow keys  to
  1178.           scroll through the  current message's  lines.  Once  the line  is
  1179.           displayed, you may modify it as desired, then press ENTER to save
  1180.           it.
  1181.  
  1182.           Write New - Creating New Message
  1183.           --------------------------------
  1184.           Replying to existing  message is fun, but if you  want to start a
  1185.           new "conversation",  what do you do?   When you wish  to create a
  1186.           new, "unprovoked" message, Select  this option, "Write new", from
  1187.           the Packet Main Menu.
  1188.  
  1189.           The Conference Selection List  will be displayed, but it  will be
  1190.           different  from  the  display  of  conferences  with  mail.   All
  1191.           conferences  supported by the source  BBS will be  listed, and no
  1192.           count or messages is  given.  Choose the conference where the new
  1193.           message  is to  be posted.   You  will then  be walked  through a
  1194.           procedure identical  to  "replying" to  a message.   The  Message
  1195.           Header form will default to a target user of ALL,  you may change
  1196.           this as desired.  Also, since you are not replying to an existing
  1197.           message,  no quoting  is performed,  and an  empty reply  file is
  1198.           provided.  Enter your new message and save it.  MR/2  will add it
  1199.           into the reply file for uploading to the BBS.
  1200.  
  1201.           You  may  review and  edit any  "new"  messages by  accessing the
  1202.           replies  conference.   To  MR/2 and  all  other QWK  readers, new
  1203.           messages are just replies with no reference message.
  1204.  
  1205.           New File Listings
  1206.           -----------------
  1207.           If a  "new files" listing  was provided in  the QWK packet,  this
  1208.           option will  be  displayed  using  "bright" letters  and  may  be
  1209.           selected.  If chosen, the new files listing will be displayed for
  1210.           your viewing.   You  may use the  Page Up and  Down keys  to move
  1211.           about the file, as well as the arrow keys, spacebar, HOME and END
  1212.           keys.   As an added  option, you may  press "E" to  view the file
  1213.           listing using your specified editor.
  1214.  
  1215.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  1216.           won't really do much.
  1217.  
  1218.  
  1219.  
  1220.           ----------------------------------------------------------------
  1221.           MR/2 User's Guide                                      Page  20
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.           Bulletins
  1230.           ---------
  1231.           If the current packet contains any bulletins, this option will be
  1232.           displayed using "bright" letters and may be selected.  If chosen,
  1233.           a list of all bulletins found will be displayed.
  1234.           If you pick any bulletin  from the list it will be  displayed for
  1235.           your viewing.   You may  use the Page  Up and Down  keys to  move
  1236.           about the file, as well as the arrow keys, spacebar, HOME and END
  1237.           keys.  As an added option, you may press "E" to view the bulletin
  1238.           listing using your specified editor.
  1239.  
  1240.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  1241.           won't really do much.
  1242.  
  1243.           While viewing a bulletin,  pressing ESCAPE will take you  back to
  1244.           the  Bulletin Selection List.  Pressing ESCAPE at this point will
  1245.           return you to the Packet Main Menu.
  1246.  
  1247.  
  1248.           The NEWS File
  1249.           -------------
  1250.           If a "news file" was provided in the QWK packet, this option will
  1251.           be  displayed using  "bright" letters  and may  be selected.   If
  1252.           chosen, the  news file will be  displayed for your  viewing.  You
  1253.           may use the Page Up and Down keys to move about the file, as well
  1254.           as the  arrow keys,  spacebar, HOME  and END keys.   As  an added
  1255.           option,  you may press  "E" to view  the file  listing using your
  1256.           specified editor.
  1257.  
  1258.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  1259.           won't really do much.
  1260.  
  1261.  
  1262.           Exiting the Current QWK Packet
  1263.           ------------------------------
  1264.           You  can exit  MR/2 by  pressing ESCAPE  at the  Packet Selection
  1265.           List, or by using the "Fast Exit" option while viewing a message.
  1266.           Fast Exit does not perform cleanup nor does it actually pack your
  1267.           replies.   Its purpose is  to provide  a quick way  to exit  MR/2
  1268.           where the intention is  to return shortly and work  with the same
  1269.           packet.   Exiting by escaping from the Packet Selection screen is
  1270.           the more "normal" way of leaving MR/2; all packets are closed and
  1271.           all reply message saved using this method.
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.           ----------------------------------------------------------------
  1282.           MR/2 User's Guide                                      Page  21
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.           CONTACTING THE AUTHOR
  1291.           =====================
  1292.  
  1293.           You  can contact me in a number  of ways.  Unfortunately, I can't
  1294.           provide a phone number at this time.
  1295.  
  1296.                US Mail:       Nick Knight
  1297.                               1823 David Ave.
  1298.                               Parma, Ohio 44134
  1299.  
  1300.                Fido netmail:  1:157/2 to "Nick Knight"
  1301.  
  1302.                Fido Echomail: Echomail messages to  me are discouraged,  as
  1303.                               keeping  them "on  topic" and  interesting to
  1304.                               the  masses would  be difficult.   I  do read
  1305.                               OS2,  OS2PROG, C_PROGRAMMING,  C_PLUSPLUS and
  1306.                               DR DEBUG  daily, though.   OFFLINE  echo also
  1307.                               (deals  with mail readers), this might be THE
  1308.                               place to ask public questions, eh?
  1309.  
  1310.                Direct BBS:    Leave  a  message  on  the  Nerd's  Nook  BBS
  1311.                               (1:157/2)  at  (216)  356-1772,  356-1872  or
  1312.                               356-1431.   I check in here  multiple times a
  1313.                               day.  I  will also keep the most  recent copy
  1314.                               of   MR/2  posted   here.      Other   boards
  1315.                               (non-local)   will   get   updates    at   my
  1316.                               convenience.
  1317.  
  1318.                               Nerd's does support file requests
  1319.                                    (157/2 or 157/3)
  1320.  
  1321.                               Optionally, I call into PC-OHIO regularly.
  1322.  
  1323.                Compuserve:    I check in  here only  when I have  to.   Try
  1324.                               mail to  my  user ID  - 76066,1240,  although
  1325.                               this isn't the best approach.
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.           ----------------------------------------------------------------
  1343.           MR/2 User's Guide                                      Page  22
  1344.  
  1345.